home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / sluf40.zip / SLUF.DOC next >
Text File  |  1991-11-06  |  9KB  |  230 lines
  1.                    =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  2.                    SLUF - Searchlight Logoff User-Feedback
  3.                                    V4.0 Beta             
  4.                    =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  5.  
  6.                              By: Greg Belanger
  7.                        The Arcade BBS (403) 273-3503
  8.                           Calgary, Alberta CANADA       
  9.                     *- USR HST Dual Standard Equipped -*      
  10.                                  
  11.                                
  12.  
  13. =-=-=-=-=-=-=
  14. What is SLUF?
  15. =-=-=-=-=-=-=
  16.  
  17. SLUF is a program that will allow a BBS user to send FeedBack to the
  18. SysOp, just before logging off.  It's a LAST-CHANCE-GET-IT-OFF-YOUR-CHEST
  19. message editor.  While the program is relatively simplistic, it will
  20. send the Message DIRECTLY to the SYSOP's mailbox.  No need to use SLMAIL,
  21. SLUF will do it all.
  22.  
  23.  
  24. =-=-=-=-=-=-=-=-
  25. Getting Started:
  26. =-=-=-=-=-=-=-=-
  27.  
  28. SLUF is EXTREMELY easy to install.  Simply add it to your LOGOFF AUTODOOR
  29. and specify the parameters and away you go!  The first parameter is the
  30. USERS NAME, second parameter is the GRAPHICS mode, third parameter is the
  31. NAME you want the Logoff message to be sent to (I.E. SYSOP for sysop
  32. account), the fourth parameter is a Yes/No option which tells
  33. SLUF whether you want the SLUF brag line to be included in the message,
  34. the fifth parameter tells SLUF to limit the MAXIMUM NUMBER of Message
  35. Lines to the value you specify.  In the following examples it is 30 but
  36. can be set to whatever value you like.  
  37. SLUF uses SL's COMM routines, so set COMM SUPPORT to Standard.  SLUF also 
  38. uses a TEMPORARY Text file, so set WRITE PROTECT to NO.
  39.  
  40. ** Use the SL Metacharacters to pass the Current Users name and Graphics
  41. mode to SLUF --  %U and %G **
  42.  
  43. ========
  44. EXAMPLE:
  45. ========
  46.  
  47.    SLUF %U %G SYSOP N 30
  48.  
  49.    --> Would send the current Users Name and Graphics mode to SLUF
  50.        and specify SYSOP as the recipient of the message, and
  51.        SLUF Would NOT add a SLUF Brag line to the message.  The 30
  52.        would tell SLUF to set the maximum number of message LINES
  53.        to 30. 
  54.  
  55.    SLUF %U %G GREG_BELANGER Y 30
  56.  
  57.    --> Would send the current Users Name and Graphics mode to SLUF
  58.        and specify GREG BELANGER as the recipient of the message, and
  59.        SLUF WOULD add a SLUF brag line to the message.  The 30 would
  60.        tell SLUF to set the maximum number of message LINES to 30.
  61.  
  62.  
  63. ************
  64. IMPORTANT!!!
  65. ************
  66.  
  67. - If the Account which you direct the message to is more than ONE word, add
  68.   an UNDERSCORE between EACH name, and ENSURE the name is COMPLETELY in CAPS.
  69.  
  70. - Searchlight BBS only allows a MAXIMUM of 400 Lines for each message.
  71.   SLUF will allow up to 400 as well, but if a value is set LARGER than 400,
  72.   SLUF will default to 99 lines.
  73.  
  74.  
  75. EXAMPLE:
  76.  
  77.        You wish to send the message to DAR THE VICTORIOUS:
  78.  
  79.        SLUF %U %G DAR_THE_VICTORIOUS N 30
  80.  
  81. This allows SLUF to recognize the parameter as ONE and not THREE different
  82. parameters.  SLUF will REMOVE the UNDERSCORE, and direct the message to the
  83. correct account: DAR THE VICTORIOUS.
  84.  
  85.  
  86.  
  87. -=-=-=-=-=-=-=
  88. Maximum Lines:
  89. -=-=-=-=-=-=-=
  90.  
  91. SLUF will allow as many lines for the message as you specify, up to the
  92. MAXIMUM of 400 as defined by Searchlight BBS.  SLUF DEFAULTS to 99 
  93. if you do not set the parameter, or specify a value that exceeds 400.
  94. At the Line limit, the User will be asked whether they wish to
  95. SAVE or ABORT the message...Entering Y or N will SAVE or ABORT the message.
  96.  
  97.  
  98. -=-=-=-=-=-=-=-=-=-
  99. Entering A Message:
  100. -=-=-=-=-=-=-=-=-=-
  101.  
  102. After sluf has loaded, the user is presented with an SL-style
  103. Yes/No prompt on whether they wish to send Feedback to the sysop.
  104.  
  105. After the Yes/No prompt, the user is presented with a screen which displays 
  106. the header and various bits of information.  Below the header is the message
  107. editor, which shows the CURRENT line number.  After 10 lines of text have
  108. been acepted, the screen will clear and the header and editor screen will be
  109. re-drawn.  This presents the user with a much nicer display.  After the user
  110. has typed the message, all they have to do is ENTER a ! to ABORT the message
  111. or a * to SAVE the message.  The only requirement to do this is that the !
  112. or * MUST be entered on a BLANK line, at the left-most space.  Once an
  113. option is chosen, SLUF will inform the user that the message is being saved
  114. or aborted and will promptly exit.
  115.  
  116.  
  117. =-=-=-=-=-=-=-=
  118. Error Messages:
  119. =-=-=-=-=-=-=-=
  120.  
  121. In the event that the Searchlight Config files cannot be found or are 
  122. damaged, SLUF will inform the user by flashing the appropriate message.
  123. The program will then exit with ABORTED MESSAGE.  The two most common
  124. messages that may be displayed in the event of an error are:
  125.  
  126. CONFIG FILE ERROR -- CONTACT SYSOP
  127. SUBBOARD ERROR -- CONTACT SYSOP
  128.  
  129. These will only be displayed if the files are DAMAGED or are NOT FOUND.
  130.  
  131.  
  132. -=-=-=-=-=-
  133. Disclaimer:
  134. -=-=-=-=-=-
  135.  
  136. I have had a growing urge to produce my own SL utility, so here it is.
  137. While this program may not be completely bug-free, I have done significant
  138. testing to ensure that all MAJOR bugs have been squashed.  I do NOT
  139. guarantee that this software will run properly, nor will I be responsible
  140. for any damage that may occur to your computer hardware or software while
  141. using SLUF.  I feel that SLUF is relatively safe to run.   All the
  142. safeguards possible have been installed to provide maximum security for your
  143. system and files while SLUF is in operation.
  144.  
  145. SLUF was tested ONLY with MSDOS 5.0, if you encounter problems with SLUF,
  146. please discontinue using the product and inform me.  I will do my best
  147. to correct the problems.  SLUF *SHOULD* run fine under IBM DOS 
  148. and MSDOS 3.0 or later. 
  149.  
  150.  
  151. -=-=-=-=-=-
  152. About SLUF:
  153. -=-=-=-=-=-
  154.  
  155. I have been programming in Pascal for several years.  It started with my
  156. first introduction to Turbo Pascal 4.0 in High School and I have continued
  157. to enjoy (sometimes!) programming various personal utilities and programs in
  158. my spare time.  I have tried virtually every SL 3rd party utility in
  159. existance, and I'm sure most will concur that this program does not even
  160. come close.  While SLUF is not fancy, it gets the job done.  I had not seen
  161. a Logoff feedback utility for SL 2.15, and always thought it was something
  162. that SL lacked... so that is why SLUF was produced.  SLUF took a few hours
  163. to piece together...While the idea is fairly simplistic, the coding was not.
  164. SLUF incorperates many little tricks which were suggested by friends, as
  165. well as some code by Frank LaRosa for the message import and Subboard
  166. identification.
  167.  
  168.  
  169. -=-=-=-=-=-=-=-=-=-=-=-=-=-=
  170. A Word About 3rd Party-ware:
  171. =-=-=-=-=-=-=-=-=-=-=-=-=-=-
  172.  
  173. Over the last couple of years,  I have noticed more and more authors
  174. DEMANDING payment for programs they create.  While I understand the work put
  175. into these BBS 'helpers' I am distressed by the fact that BBS operators
  176. should have to CONTINUOUSLY and NEVER-ENDINGLY pay for these utilities.
  177. That's why I choose to write FREE-WARE.  I support the idea of a bbs, where
  178. utilities and programs are shared.  Bbs operators are an amateur group
  179. of hobbyists and I don't believe a BBS operator should have to continuously
  180. pay for a hobby he/she already pays enough for.  The BBS operator is a fine
  181. species..One who allows people he/she doesn't even know to gain access to
  182. their system, out of the goodness of his/her heart.  I ask all you authors 
  183. who are so valuable to the Searchlight community to join me in providing 
  184. all our fellow SL sysops with quality FREE-WARE.  Donate some of your time 
  185. and expertise to the cause...It'll make the BBS community a much better 
  186. place!
  187.  
  188.  
  189. =-=-=-=-=-=-=-=-=
  190. Closing Comments:
  191. =-=-=-=-=-=-=-=-=
  192.  
  193. SLUF is FREE.  COMPLETELY FREE.  I ask no fee for using this software, but I
  194. do however ask that you do NOT modify the file, or crack (dis-assemble) the
  195. code in any manner.  If you find this program of value, and you want to
  196. contribute something, by all means send whatever you feel is fair.  My real
  197. payment is that you find this program of value, and I thank you for taking
  198. the time to read about SLUF.  If you have any problems, bug reports, general
  199. questions or concerns, please address them to the following address:
  200.  
  201.                                Greg Belanger
  202.                          3241 Doverville Crescent S.E.
  203.                              Calgary, Alberta
  204.                                   CANADA
  205.                                   T2B1V1
  206.  
  207.             ...Or contact me at any of these Network Addresses:
  208.  
  209.                            1:134/48  -- FidoNet
  210.                          201:5500/48 -- MetroNet
  211.                           99:9305/48 -- EggNet
  212.                          250:420/750 -- SL_Net
  213.  
  214.   
  215.            ...Or Call my bbs at (403) 273-3503  (24 Hours & HST)
  216.  
  217.  
  218.      ** The LATEST Version of SLUF is ALWAYS File Requestable as SLUF **
  219.  
  220.  
  221.                    Thanks for taking an interest in SLUF!
  222.  
  223.  
  224.  
  225. -------------------------------------------------------------------------------
  226. Searchlight, SL & SLBBS are registered trademarks of Searchlight Software, Inc.
  227. MSDOS is a registered trademark of Microsoft, Inc.
  228. IBM is a registered trademark of International Business Machines, Inc.
  229. -------------------------------------------------------------------------------
  230.